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PREFACE 


This manual provides the programmers and operators of Series 16 computer systems 
with the information necessary to use the following Honeywell-supplied source language 
processors: 

016-XREF Cross-Reference Listing 

SSUP Symbolic Source Update 

MAC Macro Instruction Processor 

Elements of the languages, examples of their use, exception conditions, and related 
supporting programs are described. Instructions for generating stand-alone systems and 
instructions for executing the programs are also included. 

The reader is assumed to have a basic familiarity with Series 16 assembly language 
programming and to have read the 316/516 Programmers' Reference Manual , Order Number 
BX47 (formerly M-490). 

The illustration on page v provides an overview of the relationship among the three pro- 
cessors and other elements of the assembly language system. 
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SECTION I 


MAC MACRO PROCESSOR FOR DAP- lb 


The Macro Processor (MAC) is a single-pass processor used to expand DAP-16 
Assembly Language sources containing prototype macro definitions and statements. Macro 
definitions can be entered from a separate library or they can be embedded in a single 
source. The definitions are retained in main memory for the duration of the job. As the 
macro prototypes are expanded according to a macro statement, the actual arguments of 
the macro statement replace the dummy arguments of the macro definition. The MAC out- 
put is ssembly source code which is suitable for input to the DAP-16 Mod 2 Assembler. 

GENERAL DESCRIPTION 

1’he macro language provides a convenient way to generate a desired sequence of 
assembly language statements many times in one or more programs. The macro definition 
which defines the desired sequence of statements is written once near the top of the pro- 
gram. Then, a single statement, the macro statement, is written each time the desired 
code is to be generated. This simplifies program coding, reduces the chance of program- 
ming error, and ensures that standard sequences of statements are used to accomplish de- 
sired functions. 

Conditional assembly can also be used with the MAC processor. In this way, state- 
ments can be coded which may or may not be assembled, depending upon conditions evalu- 
ated at assembly time. These conditions are usually tests of values, which can be defined, 
set, or changed during a macro expansion. 

Macro Definition 

Every macro definition is divided into three major components: the header (or first) 
statement, the body of the macro which specifies the prototype, and the end (or last) 
statement. 

HEADER STATEMENT 

The first record of every macro definition must conform to the following: 

Macro Name MAC(*) (list of arguments used) (comments) 

i i 

Field 1 Field 2 Field 3 - Optional 

(*) - Optional 
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Field 


Columns 


Contents 


1 


2 


3 


1 through 4 


6 through 8 

9 


1 2 through 7 2 


Macro name, maximum of four char- 
acters (cannot have 4 ' or $ as first 
character). 

The letters MAC. 

An asterisk if the macro expansion 
is to be preceded by two comment 
records. A space if the comment 
records are to be omitted. 

An optional argument list, comments, 
and/or identification statements which 
are ignored by the processor. 


MACRO DEFINITION BODY 

The body of the macro definition (DAP-16 format assumed) consists of prototype 
code containing dummy variables. The dummy variables are replaced by the arguments 
passed in the macro statement when the statement is expanded. The expanded source code 
is output in the same relative position from which the macro instruction statement was 
read. Comment lines within the definition will be output unchanged when the macro proto- 
type is expanded. Any occurrence of the character pair #0 will be replaced by a single 
digit between one and nine which represents the number of actual arguments in the macro 
statement (call). This digit can be less than, equal to, or greater than the number of 
dummy arguments, but in no case can it exceed nine. 

Any occurrence of the character pairs #1 through #9 will be replaced by a copy of 
the corresponding actual argument when the macro is expanded. This point is illustrated 
in the examples which follow. 

Mac ro statements referencing previously defined macros are allowed in the body of 
a macro definition. Macro names included in the argument list require additional passes 
to complete expansion (i. e. , the MAC processor is not re-entrant). Likewise, recursive 
use requires an additional number of passes equal to the degree of recursiveness. 


END STATEMENT 

The last record of every macro definition must contain the following: 

( ) ENDM ( ^ )_ 

Field 1 Field 2 field 3 
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Field 

Columns 

Contents 

1 

1 through 5 

Ignored. 

2 

6 through 9 

The letters ENDM. 

3 

1 0 through 1 20 

Ignored. 

Macro Statement 



A macro statement can call a macro any 

number of times after the macro has be< 

defined by the macro 

definition. Each macro statement must contain the following: 

(label) 

Macro Name 

(arg 1, arg 2. . . . arg 9) (comments) 

~T 

Field 1 

Field 2 

Field 3 

Field 

Columns 

Contents 

1 

1 through 4 

Label or blank. 


5 

Ignored . 

2 

6 through 9 

Name of macro being called. 


10 and 11 

Ignored. 

3 

1 2 through 7 2 

The argument list terminated by one 


or more blanks. Each argument 
may consist of any number of char- 
acters. Any character may be used 
except a comma or a blank. A pound 
sign (#, '243) is converted into a 
blank during the expansion. Argu- 
ments are separated by commas. 

Null arguments are acceptable. 

73 through 120 Ignored. 

Data Format 

Source data for MAC is prepared in a manner similar to the source data for DAP-16. 
If the standard input routines are used, tabs will be set at columns 6, 12, 30, and 73. The 
backslash character can be used to compress the source tape. If MAC output is punched 
on paper tape using the standard output routines, backslash characters are used to tab to 
columns 6, 12, 30, and 73. 

End-of-text records (ETX, '003 or '203 on the ASR or high-speed reader, or 11-8-6 
for cards) are ignored on input and are not generated on output. 

Input will be halted during a job upon detection of a MOR pseudo -operation. This 
feature allows the concatenation of macro libraries and other sources. It also allows the 
changing of input device selection. 
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One file per job is processed by the MAC processor. If the source is entered from 
paper tape or cards, the file must be terminated by a record containing a dollar sign ($, 

'044 or ’244) in column 1. The letters END may follow in columns 2 through 4. On mag- 
netic tape, files may also be terminated by a tape mark. 

Magnetic tape input allows records of up to 120 characters. This facilitates the 
processing of source material with the Honeywell Series 16 FORTRAN system, which 
writes 1 20 - character formatted records. 

Magnetic tape output is written in 120-character records. Thus, subsequent language 
processors must accept this record length. 


Errors 

MAC recognizes five error conditions. For each of these, a message is printed on 

the teletypewriter in the following form: 

* (error flag) record being processed 


The error flags are listed in Table 1-1. 


Table 1-1. MAC Error Messages 


Error Flag 

Description 

A 

More than nine arguments in the actual argument list. 

The request for the number of arguments (#0) is not 


counted. 

F 

Field overflow in macro expansion. An attempt has been 
made to store a character other than a space in or beyond 
columns 5, 11, 29, or 72. MAC ignores this error. 

M 

MAC pseudo -operation in macro definition. This record 
is ignored. 

O 

Memory overflow. There is insufficient spa.ee in the free 
core area to store all macro definitions. This error ends 


the job. 

P 

Formal argument not #0 through #9. A # which is not fol- 
lowed by a single decimal digit has been detected within a 
macro body. This error is not detected until the macro 
is expanded. MAC goes to the next field of the current 
record of the macro body. 


SYSTEM GENERATION 

The generation of a MAC system is done in a straightforward fashion. The relocatabl 
object of MAC is loaded, usually at the default starting address of '1000. It will call the 
relocatable input/output supervisor, MAC-IOS, which in turn will call the off-line I/O 


1 -4 


#AC94 



driver programs. The drivers for the desired devices, including the magnetic tape sup- 
port package, may be loaded in any order. Finally the calls for unwanted devices must be 
satisfied with G$DR, which will also pass to MAC-IOS the bounds of available memory. 

II G$DR is loaded in the extended desectorizing mode (EXD), MAC will be entered 
in the extended mode (EXA) and memory' through 32K will be used. If G$DR is loaded in 
the normal desectorizing modi' (LXD), MAC will be entered in the normal mode (DXA) and 
memory through 16K will be used regardless of the presence of additional memory. 

The keyword is loaded at G$DR, which may be located by obtaining a core map. As 
loaded, the keyword contains '000022, which selects paper tape input (with parity') and 
output. The keyword default value may be changed at this time. 

OPERATION (Keyword) 

Prior to starting MAC, the source to be expanded, which must have all macro proto- 
types physically before they are required, must be ready, as must the output device. Set 
the keyword in the A register if other than the default value is used and start at the first 
address of MAC, normally '1000. 

The source will be read until either a MOR pseudo -ope ration is encountered or a 
MAC end-of-file is detected. The latter must be either a dollar sign in column 1 or a tape 
mark. Any ETX records on paper tape or cards are ignored. The MOR pseudo-operation 
will cause the message MORE to be typed and the processor will stop for operator action. 
The keyword, which may be changed before restart, will be displayed in the A register. 

Output may be generated immediately depending upon the input data. If paper tape 
is being used, MAC will punch leader and trailer. 

The A register must be set with the keyword at' the start of the program. If the word 
is zero, the default word ('000022 unless changed at system generation) will be used. If 
any bit is set, the A register must contain the entire desired keyword. The A register 
setting for the keyword is shown on the following page. 
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Process Control 


_T 


0 - Normal output 

1 - Errors only output 


11 12 13 14 15 16 


Source Device ■ 


1 - ASR 

2 - Paper tape reader 

(even parity) 

3 - Card reader 

4 - Paper tape reader 

(no parity) 

5 - Magnetic tape logical 0 

6 - Magnetic tape logical 1 

7 - Magnetic tape logical 2 


Output Device 

0 - No output 

1 - ASR 

2 - Paper tape punch 

3 - Card punch 

4 - Line printer 

5 - Magnetic tape logical 0 

6 - Magnetic tape logical 1 

7 - Magnetic tape logical 2 


MESSAGES 

The only non-error run message is MORE, which indicates that a MOR pseudo- 
operation was encountered. 

A MAC error message may be typed as indicated in "Errors" above. Other error 
messages are: 

DEVICE NOT AVAILABLE 

RECORD UNREADABLE (magnetic tape only) 

END OF TAPE (input or output, magnetic tape only) 

The end of job is indicated by: 

** MACRO ERRORS 
or NO MACRO ERRORS 

PAPER TAPE PARITY 

MAC includes support of paper tape punched with even parity. Honeywell does not 
supply Teletypes equipped to punch parity in the United States, but the option is common 
elsewhere. An error is processed within the driver program and the appropriate docu- 
mentation must be consulted for advice. All output on the paper tape punch is made with 
level 8 marking ( i . e . , punched). 

TERMINATION 

At the end of the job, magnetic tape input is positioned after the tape mark or the 
dollar sign record. An output tape will have a tape mark but not an $END record. The 
output tape is left just beyond the tape mark. 
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Other output devices will be terminated with a record containing $END columns 1 
through 4. 

The A register will contain the keyword. A new job may be started from the halting 
location. 

INTERNAL MAC EXPANSION PROCESSING 

The input stream is scanned for macro instruction statements one record at a time. 
Upon detecting a macro instruction statement, two comment records are output, if the 
Prototype indicates the selection {an asterisk in column 9 of the first prototype statement). 
The first optional comment record contains an asterisk in column 1, followed by blanks. 
The second contains an asterisk in column 1, blanks in columns Z through 4, and a copy of 
the macro statement in column 5 through 120. 

Following the comment records, the prototype is expanded. Each record of the 
macro prototype is examined and comment records within the macro definition are output 
unchanged. Other records are expanded field by field (i.e., columns 1 through 5, 6 through 
11, L through 29, and 30 through 72). Any occurrence of the character pair #0 is replaced 
by a single digit between 1 and 9 that represents the number of actual arguments found in 
the input record. The character pairs #1 through # 9 are replaced by their respective ac- 
tual arguments listed in the macro statement (i. e. , #1 is replaced by the first actual argu- 
ment, # 2 is replaced by the second actual argument, etc. ). If the actual argument does 
not exist, the whole record is ignored and MAC goes to the next record of the macro pro- 
totype. All pound signs in the arguments are converted to spaces in the output record, 
except in the two optional comment records preceding a macro expansion. 

Any noncomment records which have an operation field (columns 6 through 9) pre- 
viously defined by a stored macro definition are expanded. All other records are copied 
unchanged. 

MEMORY REQUIREMENTS 

The macro prototypes are packed into core. The MAC and ENDM records require 
a total of seven half-words. For other records in the macro prototypes, one half-word is 
required for each nonspace character, one-half word is required for each sequence of 
spaces not at the end of a record, and one-half word additional is required for each record. 

MACRO EXAMPLES 

Five examples of macro applications are presented in this section. If the MAC output 
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is punched on paper tape, it contains backslash ch.irai ters to 
12, 30, and 73. The MAC output listings in this manual have 
tab position for each ol reading. 


represent tab to columns 6, 
been expanded to the correct 


Generation of Calling Sequences Using Subroutines 

If a subroutine is called many times during a long program, a macro definition of 
the calling sequence can be written. A typical macro definition for a call to subroutine 
YORN is: 


MAC* 

# 1 ,# 2 . 

TEST FOR YES OR NO 

JST 

YORN 

YES OR NO ROUTINE 

JMP 

A 1 

NO 

JMP 

#2 

YES 

INVALID CHARACTER 

ENDM 

MOR 


END OF MAC YORN 


After the macro has been defined, a macro statement which references the macro 
definition can be inserted at any point in the coding: 


YORN U,V5 


TEST ANSWER 5 


MAC expands the prototype which generates the coding shown below. The first two 
lines are the optional comment lines, which have been generated because the first state- 
ment of the macro definition contains an asterisk in column 9- 


* 


* 

YORN 

U,V5 

TEST ANSWER 5 


JST 

YORN 

YES OR NO ROUTINE 


JMP 

U 

NO 


JMP 

V5 

YES 


INVALID CHARACTER 


Use of #0 in Macro Expansion 

Any occurrence of the character pair #0 will be replaced by a single digit between 0 
and 9 when the macro is expanded. The number which replaces the character pair #0 rep- 
resents the number of actual arguments passed from the macro statement. It can be less 
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than, equal to, or greater than the number of formal arguments but in no case can it 
exceed 9. 

In the following example, the prototype code for the previous example is modified by 
adding the character pair #0 in three places: 


YORN 

MAC* 

# 1 ,# 2,#0 

TEST FOR YES OR NO 


JST 

YORN 

YES OR NO ROUTINE 


JMP 

0 \ 

N0,#0 

* 

JMP 

ENDM 

MOR 

#2 

YES 

INVALID CHARACTER, #0 
END OF MAC YORN 


The same 

macro statement is used to 

cause the expansion shown b 

* 

* 

YORN 

U, V5 

TEST ANSWER 5 


JST 

YORN 

YES OR NO ROUTINE 


JMP 

U 

NO, 2 

★ 

JMP 

V5 

YES 

INVALID CHARACTER, 0 


Note that the first occurrence of the character pair #0 was in the dummy argument 
list and does not appear in the expansion. The second occurrence of § 0 is in a coding line 
and is replaced by 2, which is the number of actual arguments. The last occurrence of #0 
is in a comment line. In this case, the pound sign is taken as a space and the character 0 
is printed unchanged. 


Generation of Complete In-Line Coding 

This type of coding may be inefficient in terms of memory used, but it is simpler 
than calling a subroutine and runs faster. An example containing two macro definitions 
is presented in Figure 1-1. The macro definitions are placed at the beginning of the pro- 
gram. The macro statements which reference the macro definitions are placed within the 
body of the program as frequently as desired. 


MAC generates the coding presented in Figure 1-2 each time the prototypes are 
expanded. 
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FILL 

• 

• 

• 

mac* 

# 1 ,*2,#3 

FR OM ,WI YH ,L0iJ NT 


LDX 

= -#3 

#3 WORDS 


LDA 

#2 

FILL WITH #2 


STA 

» l+#3, 1 

STARTING WITH # 1 


IRS 

0 

TALLY INDEX 


JMP 

*-2 

REPEAT TO END OF BUFFER 


EN DM 


END OF ^ A C FILL 

COPY 

MAC* 

# 1 ,#2. ,#3 

FR OX ,T 0, COUNT 


LDX 

z-# 3 

tf 3 WORDS 


LDA 

tt l+#3, I 

COPY FROM #1 


STA 

#2+#3, 1 

TO H? 


IRS 

0 

TALLY INDEX 


JMP 

*-3 

REPEAT TO END OF BUFFERS 


ENDM 

• 


END OF MAC COPY 


• 

• 

Macro 

Definitions 


• 

COPY 

IN, OUT, 36 

COPY TO OUTPUT SUFFER 


FILL 

• 

• 

IN ,=A## ,60 

CLEAR INPUT BUT 'ER 


• 

Macro In 

-Line Coding 


Figure 1-1. In-Line Coding Example — Source Input 


* 

* 

• 

• 

• 

COPY 

IN , OUT, 36 

COPY TO OUTPUT PUFFER 


LDX 

= -36 

36 WORDS 


LDA 

IN+36, 1 

COPY FROM IN 


STA 

OUT+36 , 1 

TO OUT 


IRS 

0 

TALLY IN6EX 


JMP 

• 

• 

*-3 

REPEAT TO END OF BUFFERS 

* 

* 

• 

• 

FILL 

IN ,=A## ,60 

CLEAR INPUT BUFFER 


LDX 

--60 ' 

60 WORDS 


LDA 

=A 

FILL WITH - A 


STA 

IN+60, 1 

STARTING WITH IN 


IRS 

0 

TALLY INDEX 


JMP 

• 

• 

• 

*-2. 

REPEAT TO END OF BUFFER 


Figure 1-2. MAC Expansion of In-Line Coding 
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Using Macros to Implement Interpretive Sch e me 

In this example, a scheme is presented which will allow the coding of a process of 
several steps involving complex variables. The macro definitions used in this example 
are presented in Figure 1-3. 

With these macro definitions, it is possible to code the complex equation 
Y = A * SIN (A * T1 + B * T2) * COS (B * Tl-A *2) 
as the series of macro statements shown in Figure 1-4. 

The assembled output of MAC will be similar to the listing presented in Figure 1-5. 
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MAC 

1 



CALL 

LS55 

LOAD COMPLEX VARIABLE 


DAC 

# ! 



ENDM 


END OF MAC BLANK 

+ 

MAC 

1 



CALL 

AS 5 5 

COMPLEX ADD 


DAC 

#1 



ENDM 


END OF MAC + 

- 

MAC 

1 



CALL 

SS55 

COMPLEX SUBTRACT 


DAC 

#1 



ENDM 


END OF MAC - 

X* 

MAC 

#1 



CALL 

MS55 

COMPLEX MULTIPLY 


DAC 

#1 



ENDM 


END OF MAC X* 

/ 

MAC 

#1 



CALL 

DS55 

COMPLEX DIVIDE 


DAC 

#1 



ENDM 


END OF MAC / 

NEG 

MAC 




CALL 

N$55 

COMPLEX NEGATE 


DAC 

#1 



ENDM 


END OF MAC ”EG 

: 

MAC 

1 



CALL 

HS55 

STORE COMPLEX VARIABLE 


DAC 

#1 



ENDM 


END OF MAC = 

SIN 

MAC 




z 

W 



CALL 

CSIN 

COMPLEX SINE 


DAC 

W 



ENDM 


END OF MAC SIN 

COS 

MAC 




w 



CALL 

CCOS 

COMPLEX COSINE 


DAC 

ENDM 

W 

END OF MAC COS 

EXP 

MAC 





W 



CALL 

CEXP 

COMPLEX EXPONENTIAL 


DAC 

ENDM 

W 

END OF MAC EXP 

LN 

MAC 





W 



CALL 

CLOG 

COMPLEX LOG 


DAC 

ENDM 

W 

END OF MAC LN 

SORT 

MAC 




- 

W 



CALL 

CSQRT 

COMPLEX SQUARE ROOT 


DAC 

ENDM 

W 

END OF MAC SQRT 

ABS 

MAC 





W 



CALL 

CABS 

COMPLEX ABSOLUTE 


DAC 

ENDM 

W 

END OF MAC ABS 


MOR 




Figure 1-3. Macro Definitions for Interpretive Scheme 
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Figure 1-4. Macro Statements for Interpretive Scheme 
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0001 

00000 

0 

10 00000 


CALI 

LS55 

LOAD COMPI FX VAR! A Bl E 

0002 

00001 

0 

000067 


DAC 

A 


0003 

00002 

0 

10 00000 


CALI 

M$55 

complex multiply 

0004 

00003 

0 

000064 


DAC 

T1 


0005 

00004 

0 

10 00000 


CALL 

HS55 

STORE COMPLFX VARIABLE 

0006 

00005 

0 

000054 


DAC 

WM 


0007 

00006 

0 

10 00000 


CALL 

LS55 

LOAD COMPLEX VAR I A Bl E 

0008 

00007 

0 

000065 


DAC 

B 


0009 

00010 

0 

10 00000 


CALt 

MS55 

complex multiple 

0010 

00011 

0 

000066 


DAC 

T2 


0011 

00012 

0 

10 00000 


CALL 

At55 

complex ADD 

0012 

00013 

0 

000054 


DAC 

WM 


0013 

00014 

0 

10 00000 


CALL 

HS55 

STORE COMPLFX VARIARLE 

0014 

00015 

0 

OOOO 5 O 


DAC 

W 


0015 

00016 

0 

10 00000 


CALL 

CSIN 

COMKLt* MNE 

0016 

00017 

0 

000050 


DAC 

W 


0017 

00020 

0 

10 00000 


CALL 

MS55 

complex multiply 

0018 

00021 

0 

000067 


DAC 

A 


0019 

00022 

0 

10 00000 


CALL 

HS55 

STORE COMPLFX VARIABLF 

0020 

00023 

0 

000054 


DAC 

W*4 


0021 

00024 

0 

10 00000 


call 

LS55 

load complex variable 

0022 

00025 

0 

000067 


DAC 

A 


0023 

00026 

0 

10 00000 


CALL 

M$55 

complex multiply 

0024 

00027 

0 

000066 


DAC 

T2 

S ORE CoMpLFX VARIARLF 

0025 

00030 

0 

10 00000 


CALL 

HS55 

0026 

00031 

0 

000060 


DAC 

W *8 

UaD COMpLEX VARIABLE 

0027 

00032 

0 

10 00000 


call 

L-S55 

0028 

00033 

0 

000065 


DAC 

B 


0029 

00034 

0 

10 00000 


CALL 

M-555 

coMpLpx Multiply 

0030 

00035 

0 

000064 


DAC 

ri 


0031 

00036 

0 

10 00000 


CALL 

SS55 

COMPLEX SUBTRACT 

0032 

00037 

0 

000060 


DAC 

W + 8 


0033 

00040 

0 

10 00000 


call 

H$55 

STORE COMPLFX V AH I ABLE 

0034 

00041 

0 

000050 


DAC 

W 


0035 

00042 

0 

10 00000 


CALL 

CCOS 

COMPLEX cosinf 

0036 

00043 

0 

000050 


DAC 

W 


0037 

00044 

0 

10 00000 


CALL 

MS55 

COMPLEX MULTIPLY 

0038 

00045 

0 

000054 


DAC 

W + 4 


0039 

00046 

0 

10 00000 


CALL 

HS55 

STORE COMPLEX VARIABLE 

0040 

00047 

0 

000060 


DAC 

Y 


0041 

00050 

000000 

W 

BSZ 

8 


0042 

00060 

000000 

Y 

BSZ 

4 


0043 





END 



* mmmm 


Figure 1-5. Assembler 

Listing 

for Interpretive Scheme 
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Macros Used With Conditional Assembly 


Macro prototypes can be coded to include conditional assembly statements and the 
assembly process thereby directed by the value (or presence) of certain arguments. Codin 
using conditional pseudo -ope rations to call either the ASK or line printer off-line driver 
program is shown in Figure 1-6. 

J 1 


MAC* 

#1 ,#2 

TEST FOR OUTPUT DEVICE 

IFZ 

#1-4 

ZERO IF LINE PRINTER 

CALL 

0$ LA 

CALL L.P. 

DAC 

#2 

BUFFER ADDRESS 

ENDC 


END OF L.P. CONDITIONAL 

IFZ 

#1-1 

ZERO IF ASR 

CALL 

OSLL 

CALL ASR 

DAC 

#2 

BUFFER ADDRESS 

ENDC 


END OF ASR CONDITIONAL 

IFN 

#1-1 

ASR TEST 

IFN 

#1-4 

L.P. TEST 

fail 


ERROR CONDITION 

ENDC 


END OF L.P. TEST 

ENDC 


END OF ASR TEST 

ENDM 


END OF MAC PRNT 

MOR 




Figure 1-6. Macro Definition Using Conditional Pseudo -Operations 


Following the macro definition, the line printer can be called using the following 
macro statement: 


PRNT 4, DATA 


1 =ASR,4=LINE PRINTER 


When the MAC output is assembled, the program listing will contain the line printer 

call: 

* 

* PRNT 4, DAT A 

0 A LI 0 1 L A 

D A C DATA 


1 = A C R , 4r|_ ! HP PR1HTFP 
Caii I . o . 

PIIFFFR a n n R F F 


Conversely, to call the ASR: 


PRNT 1 , DATA 


1:ASR,4:LINE PRINTER 
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results in: 


1 - ASK , 4-L I NR PRINTER 

Cali asr 
Biifffr AnnRcs^ 


P^NT 1 .DATA 
CALL n*Ll 
DAC DATA 


If neither 1 nor 4 is passed as an argument, the FAIL pseudo -ope ration will be 
assembled and an error flagged: 


PPNT 3,NDI)T 1=ARR,4 = I. INF PRINTER 

FAIL frror C n nj n i t I n n 


Trace Example Using Macros and Conditional Assembly 


In this example, a macro definition to call FORTRAN IV Trace Program F$TR from 


an assembly language program is shown. Conditional assembly pseudo -operatioS® are 
used to distinguish between a statement number (label) trace and other traces, and the call 
is adjusted accordingly. The macro definition used in this examp e is shown as Figure 1-7. 


TR 

MAC 

TYPE, NAME 


IFZ 

#1 0 = TRACE STATEMENT NO. 


CALL 

F$TR 


VFD 

3, #1 ,5, ’37,8, '240 ' 37 : HALF< , 1 240 PREVENTS AT SIGN 


BCI 

ELSE 

2, #2 


IMA 

#2 


CALL 

F$ TR 


VFD 

3 ,# 1 


BCI 

2, #2 


IMA 

ENDC 

ENDM 

#2 


MOR 



Figure 1-7. Macro Definition for Conditional Trace Example 


In the example, it was decided to trace the logical variable FLAG, the interger 
variable A, and the label TWO. F$TR requires the argument #1 to be 3, 1, and 0, respec- 
tively, to identify these types of variables. The macro statement TR and the variable type 
and name arguments were then inserted into the existing code at the points where tracing 
was desired. The results are shown in Figure 1-8. 
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* 

CF5 

TRACE EXAMPLE USING MACROS 



REL 




CRA 



LOOP 

STA 

FLAG 



TR 

3, FLAG 



SL2 




JMP 

TWO 



STA 

A 



LDA 

= -4 



STA 

CNT 


FST 

IRS 

A 



TR 

l.A 



IRS 

CNT 



JMP 

FST 



LDA 

FLAG 



ERA 

= 1 



JMP 

LOOP 


TWO 

CRA 




TR 

0 , TWO 



STA 

A 



LDA 

= -2 



STA 

CNT 


SEC 

IRS 

A 



TR 

l.A 



IRS 

CNT 



JMP 

SEC 



HLT 



FLAG 

BSZ 

1 


CNT 

BSZ 

1 


A 

BSZ 

1 



END 



£ 







Each macro statement within the coding is expanded and the actual arguments are 
substituted in the MAC output coding. A portion of this coding is presented in Figure 1-9. 

When the MAC output is assembled, the conditional pseudo-operations cause the 
inappropriate lines to be ignored. The assembly listing is presented in Figure 1-10. 


Following the assembly, the program was loaded and executed. The trace shown 
below was printed on the Teletype. The @ signs result from some assumptions within 
F$TR relative to the (normally) compiler -generated call. 


q FLA G= F 
0A = 1 

9A = 2 

0A = 3 

9A = A 

0 FLAG” T 
(TWO) 

9 A = 1 

9A- 2 
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TRACE EXAMPLE USING MACROS 


STA 

FLAG 

IFZ 

3 

CALL 

FS TR 

VFD 

3,3,5, 

BCI 

2, FLAG 

ELSE 


IMA 

FLAG 

CALL 

F$TR 

VFD 

3,3 

BCI 

2, FLAG 

IMA 

FLAG 

ENDC 


SLZ 


JMP 

TWO 

STA 

A 

LDA' 

z-4 

STA 

CNT 

IRS 

A 

IFZ 

1 

CALL 

F$ TR 

VFD 

3,1,5, 

BCI 

2, A 

ELSE 


IMA 

A 

CALL 

F$ TR 

VFD 

3,1 

BCI 

2, A 

IMA 

A 

ENDC 


IRS 

CNT 

JMP 

FST 

LDA 

FLAG 

ERA 

= 1 

JMP 

LOOP 

CRA 


IFZ 

0 

CALL 

F$TR 

VFD 

3,0,5, 

BCI 

2, TWO 

ELSE 


IMA 

TWO 

CALL 

F$TR 

VFD 

3 ,0 

BCI 

2, TWO 

IMA 

TWO 

ENDC 


STA 

A 

LDA 

:-2 

STA 

CNT 

IRS 

A 

IFZ 

1 

CALL 

F$TR 

VFD 

3,1,5 

nr t 

O A 


0: TRACE STATEMENT NO. 


0= TRACE STATEMENT NO. 


0 = TRACE STATEMENT NO. 


0 : TRACE STATE 


Figure 1 -9. Typical MAC Output Code — Conditional Trace Examplf 
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trace exampi e using macros 

0002 




CF5 


0003 




RFL 


0004 

ooono 

140040 


CRA 


0005 

00001 

0 04 00053 

LOOP 

STA 

Ft AG 

0011 

00002 

0 13 00053 


IMA 

FLAG 

0012 

00003 

0 10 00000 


CALI. 

FSTr 

0013 

00004 

060000 


VFD 

3.3 

0014 

00005 

143314 


BCI 

2.FL AG 


00006 

140707 




0015 

00007 

0 13 00053 


I MA 

flag 

0017 

00010 

100100 


SLZ 


0018 

00011 

0 01 00031 


JMp 

TWO 

0019 

00012 

0 04 00055 


STA 

A 

0020 

0001 3 

0 02 00060 


LD A 

= -4 

0021 

00014 

0 04 00054 


STA 

CNT 

0022 

00015 

0 12 00055 

pst 

IRS 

A 

0028 

00016 

0 13 00055 


IMA 

A 

0029 

00017 

0 10 00000 


call 

fs t r 

0030 

00020 

020000 


VFD 

3.1 

0031 

00021 

140640 


BCI 

2. A 


00022 

120240 




0032 

00023 

0 13 00055 


IMA 

A 

0034 

00024 

0 12 00054 


Irs 

CNT 

0035 

00025 

0 01 00015 


JMp 

FST 

0036 

00026 

0 02 00053 


LD A 

FLAG 

0037 

00027 

0 05 00057 


ERA 

si 

0038 

00030 

0 01 00001 


JMP 

LOOP 

0039 

00031 

140040 

TWO 

CRA 


0041 

00032 

0 10 00000 


CALI 

FUTR 

0042 

00033 

n ■* ~ - 


VFD 

T ~ 

0043 

nnf 1- 






Figure 1-10. Typical Assembly Listing — Conditional Trace Example 
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SECTION II 


016-XREF CONCORDANCE 


GENERAL DESCRIPTION 

The 016-XREF Concordance program prepares a cross-reference listing (concor- 
dance) of all symbols within a Honeywell DAP- 16 Assembly Language source program. 

The symbols are listed in alphanumeric order with the defining line numbers shown to the 
left (along with any exception flags) and the line numbers of all references to the symbol 
on the right. The line (record) numbers on the left are the same as the numbers shown 
on the left of a source listing or an assembly listing. Figure 2-1 shows an assembly 
listing of a source and the corresponding cross-reference. The source was written to 
show the features of 016-XREF. 

Symbol recognition is less restrictive than the similar process in the assemblers 
for the same language. Symbols which are almost acceptable are detected and the pro- 
grammer is made aware of them. 

The four exception flags are: 

M — Illegal multiple definition of symbol 

N — Symbol defined but never referenced 

3 — Legal multiple definition of symbol 

U — Undefined symbol 

Flags M and U indicate lines of a finished program which are usually clearly in 
error. The N flag indicates a symbol which is not required by the assembler and may 
point out a programmer oversight. An acceptable multiple definition is indicated by an 
S flag. 

Each reference to a symbol can have a C or J suffix to the line number to indicate 
a change or jump, respectively. The C indicates that the referenced instruction is a STA, 
DST, STX, IMA, or IRS. A J results from a JMP or JST instruction. It should be noted 
that the C and J suffixes are useful only when the nature of the code is known, since the 
actual instruction and referenced address are subject to indexing, indirect addressing, 
program self-modification, etc. 
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XREF EX AMPLE 


0001 
0002 

0003 

0004 

0005 00000 

0006 00001 

0007 00002 

0008 

0009 00003 

0010 00004 

0011 00005 

0012 00006 
0013 

M 0014 00007 

M 0015 00010 

M 0016 00011 

M 0017 00012 

0018 

0 0019 00015 

0020 00016 
00017 

0021 

0022 00020 0 02 00023 L D A 

0023 00021 0 10 00023 PQR JST 

0024 * 

0025 000022 RETA SFT 

L 0026 00022 0 000000 183 XAC 

MV 0027 000007 RETA SET 

0028 * 

M 0029 00023 000020 END 

RETA 00024 

MNO 00025 

PCD OOOOOOE JKL 000007 MNO 000025 
RETA 000024 

0009 WARNING OR ERROR FLAGS 
DAP-16 MOD 2 REV. B 10-20-70 


= 16 
= 16 


OSLA 

JKL+ABC 

JKL THIS iS A 




* 



ABC 

RFL 

APCD 



EXT 

BCD 

0 02 00000 


lda 

BCD 

0 04 00000 


STA 

BCD 

0 01 00000 


JMp 

BCD 

0 02 00016 


LDA 

= 16 

0 02 00016 


lda 

= • 20 

0 02 00016 


LDA 

= S10 

0 13 00017 


I MA 

= A X Y 

0 000016 

JKL 

DAC 

= 16 

0 04 00007 


STA 

JKL 

0 02 00007 


LDA 

JKL 

000000 

JKL 

8SZ 

3 

0 04 00024 


STA 

MNO 

000020 


FIN 

MNO 

154331 





Figure 2-1. XREF Example 


NO SYMBOLS NORMALLY HFRF 

externai definition 

NO SUFFIX 
C SUFFIX 
J SUFFIX 

THREE LITFRALS WHICH HAVE 
THE SAMF LITERAL VAIUF. BUT 
A DIFFERENT SYMBOI I C V ALUF 
C SUFFIX FOR A LITERAt 

ONE M Ft AG FROM JKL 
TWO NORMAL REFERENCES 

BOTH M AND N FLAGS FROM JKL 

u Flag on mno 

NO SYM80LS NORMALLY HFRF 


NO POOLING SHOWN 
POR GETS N FLAG 

S FI AG ON RFTA 
II l FGAL SYMBOI 
S Ft AG 

COMMENT 


POR 
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Literals are treated as self-defining symbols rather than being evaluated. There- 
fore, the terms = '20 and =16, which the assembler may evaluate, are listed separately. 

The FIN pseudo-operation used to pool the literals is ignored. 

SYSTEM GENERATION 

The generation of an XREF system is performed in a straightforward fashion. The 
ORGed object of 016-XREF is loaded and this calls for the off-line I/O driver programs 
directly, with the exception of the Disk/Drum Operating Program (DOP) and its driver. 
Drivers for the desired devices, including the magnetic tape support programs, can be 
loaded in any order. Calls for unwanted device drivers can be satisfied with DUMY-X16. 

If the Honeywell- supplied magnetic tape support package is used, the channel type 
and number (if DMC or DMA is to be used) must be entered. The 016-XREF program 
uses logical unit 1 for input (same as the assembler) and this may also require an entry. 
Complete information is contained in the appropriate option Programmers' Reference 
Manual. 

When DOP is used, the linkages can be placed in sector zero either by directly 
entering them or by starting DOP. 

The load map should be examined for a high greater than '5000. If this is the case, 
the contents of location GRMA ('464 in Rev. B) must be changed to the next higher address 
ending in octal zero. This address indicates the lowest memory usable for storing cross- 
reference data. Conversely, if the high address is much below '5000, the contents of 
GRMA can be changed to a lower address. 

Locations '1000 and '1001 contain NOPs. The second location can be used for a 
LDA SYSP with the installation preferred keyword placed m SYSP ('506 in Rev. B) if 
desired. 

OPERATION (Keyword) 

The source to be cross-referenced must be made ready on the input device prior to 
starting 016-XREF. If magnetic tape is the input device (logical unit 1), it must be at the 
first record of the desired file. The input process is normally terminated upon detection 
of either an END pseudo-operation record or an end-of-file mark. If the input was from 
magnetic tape, the tape will be rewound at this time. 
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The installation preferred keyword must be set into the A register prior to the start. 
Figure 2-2 is presented as a guide to keyword selection, if any field is left blank, the 
indicated default value for that field is assumed. 



Figure 2-2. Setting of A Register for Keyword 


Start the program at (P) = '1000. If the keyword is not acceptable, the message 
PARM ERROR is printed on the ASR and the processor halts with the keyword in the A 
register. The keyword must be changed and the processor restarted from either the halt 
address or location '1000. 

At the end of the process, the processor halts and displays the keyword in the A 
register. Another concordance can be generated using the same or a different keyword. 
The concordance is listed as soon as a single input pass is complete. 

MEMORY REQUIREMENTS AND OVERFLOW 

On the average, a symbol is defined every five lines of code and each symbol is used 
five times. Each symbol requires eight words and a reference requires two words. Based 
on a GRMA of '5000, the source programs of various size listed in Table 2-1 can usually 
be cross-referenced in one operation. 

If the available memory is filled before the input is complete, the cross-reference 
to that point is listed with flags suppressed. After the operation is complete, the message 
SEGMENT BOUNDARY and the cumulative counts are printed. Then, in effect, a program 
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restart is made which picks up the source input at the point where it left off. The final 
section is terminated with the message FI>AGS OMITTED. 


Table 2-1. XREF Memory vs Program Size 


Memory 

Records 

4K 

420 

8K 

1560 

12K 

2700 

16K 

3800 

20K 

5000 

24K 

6100 

28K 

7200 

32K 

8400 


- 


TERMINATION 

The concordance is terminated with the record, symbol, and reference counts along 
with the count of M, N, and U flags. If a segmented concordance .cas generated, the 
cumulative counts of records, symbols, and references are listed ilong with the message 
FLAG OMITTED. 

MISCELLANEOUS CONSIDERATIONS 

The first record encountered is taken as the title line for all pages. It is also 
processed as a normal record. The presence of either unexpanded macro instructions or 
conditional assembly statements can produce warning flags which must be interpreted by 
the programmer. 

External names are not indicated as such, but in general they may be noted by a 
blank-defining record field. The use of code such as 
A$BC XAC A$BC 

will obscure the external indication. References to multiply defined symbols are taken as 
referring to the first definition encountered. Subsequent definitions are listed, but they 
receive an N flag as well as an M flag. 
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SECTION III 


SSUP SYMBOLIC SOURCE UPDATE 


DESCRIPTION 

SSUP and its associated Input/Output Supervisor, SSUP-IOS, form a file maintenance 
system for Honeywell DAP- 16 Assembly Language and FORTRAN source files. Figure 
3-1 presents an overview of program flow. The old master or starting source is pro- 
cessed against the update stream, which contains both commands and new records to be 
inserted. The result of the processing is either a new master, sometimes called an 
updated source, or both the new master and a listing. 

COMMAND LANGUAGE 

The update process is controlled by commands which appear in the update stream. 
The format of the commands is presented in Figure 3-2. 

The elementary items within the square brackets may be optional. Spaces can be 
used freely to separate the elements, except that a blank must follow the single letter 
commands N and O. 

The SSUP commands consist of one or four letters. The commands and their 
functions are presented in Table 3-1. 

An F in the file/record indicator indicates that the command is to be applied to 
files rather than records. This mode is usually applicable to magnetic tape. When the 
file/record indicator is blank, the command is applied to a record. 

The limit arguments, which specify record or file numbers, are decimal integers 
not greater than 32,767. The meaning of these arguments is described in the examples 
which follow. Either or both of these arguments can be absent from all commands except 
NSRT, OMIT, BEGN, and COPY, These four commands require at least one argument. 


3-1 


#AC94 




Figure 3-1. SSUP Program Flow 



An asterisk anywhere in the command causes the remainder of the line to be treated 
as a comment. Hence, the remainder of the line is ignored for processing, but it is listed 
if commands are being listed. 


A command which contains only a comment is acceptable. 
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Table 3-1. SSUP Commands 


Command 

Function 

NSRT or N 

Insert new records. 

OMIT or O 

Omit old records or omit old records and insert 

new records. 

LIST 

List all records that come from old master plus 
all corrections that come from update source. 

NLST 

No records are listed. SSUP is initially in NLST 
mode. 

BEGN 

Position new master (used with magnetic tape only). 

COPY 

Copy old master on new master. 

NCPY 

Not generally useful: turns copy indicator off and 
nothing is written on new master. 

HALT 

Stop all I/O operations. Wait for operator action. 

RSET 

Reset input counters to record zero, file one 
(useful for concatenating old sources onto one new 
source) . 

WEOF 

Place end-of-file mark in new master. 

DON E 

Place cnd-of-file mark in new master and terminate 
SSUP process. 

DOLR 

Change command indicator (originally $) to next 
nonblank character. Useful for updating master 
files . 


SUMMARY EXAMPLE 

The example in Figure 3-3 is a typical update stream which uses the more common 
commands and functions. It is correct as shown for the old and new inasters on magnetic 
tape and the update stream on cards. The flow is generally correct regardless of the 
media . 

In general, there are several combinations of commands and limits which will 
accomplish any task. The example presented in Figure 3- 3, with- reasonable extensions 
by the reader, is a straightforward approach which can accomplish all ordinary update 
ta sk s . 
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— 

Operation 

f 

Command 

f 

Functions 

1 

Comments 

Position Output 
Tape 

$BEGNF m 

$BEGN n 

Advance output (new master) 
tape past m- 1 file marks. 

Advance output tape past 
n-1 records. 

Tape is now in position to 
write n-th record on m-th 
file of output tape. 

Position Input 
Tape 

$OF , p 

$COPYF, q 

Skip files from current 
position to beyond file p. 

Copy from current posi- 
tion through and including 
file q. 

New tape contains some 
number (between none and 
all) of files from old 
master . 

Perform 

Update 

$ N r 

Copy old master from 
current position up to and 
including (r-l)th record. 
Insert following records 
until the next command is 
found . 



(new record) 




(new record) 




$ O t 

Copy old master from 
current position up to and 
including (t-l)th record. 
Insert following records, 
if any. 



[(new record) 

* 




(new record)] 

$ O u, v 

Copy old master from 
current position up to and 
including (u-l)th record. 
Skip records u through v. 
Insert following records, 
if any. 



[(new record' 




(new record)] 



Copy •' 
Remainder of 
Input Tape 

Terminate the 
Process ^ 

$COPY F, w 

$ WEOF 

$ DONE 

Copy old master from 
curre: t >rr; 

v +T) tor ..u _ ’ 

Write end-of-file mark. 

Write end-of-file mark and 
indicate job is complete. 



'two successive end-of-file marks (i.e., a blank file) customarily indicate the end of 


data on a magnetic tape. 


Figure 3-3. SSUP Summary Example 
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LISTING 


Two types of listings, plus a no-listing option, can he obtained from SSUP. One 
listing is a transaction listing which is the default condition. All commands and comments 
are listed, along with the results of omit and insert actions. The records inserted are 
shown with a plus sign and the record number they acquired in the new master. The 
records omitted are shown with a minus sign and the record number they had in the old 
master. The transaction listing may be suppressed either by setting sense switch 4 or 
by including the LIST command. 

The LIST command overrides the transaction listing and causes the second type of 
listing to be generated. In this type, a line is output for every record read from the old 
master or the update stream. If there is no update, the resultant list is a source listing 
with the decimal record numbers printed on the left side. If no limits are stated, all 
records will be listed. If only |\ limit 2 J is stated, all records from the current position 
through record limit 2" will be listed. 

NSLT turns the LIST option off and restarts the transaction listing. 

Listings produced on the teletype are truncated after card image column 72. The 
tab format source is expanded to the conventional columns before being listed (i.e. , 
tabbed) . 

MESSAGES 

There are two SSUP error messages, NONVALID COMMAND and LIMIT ERROR. 

An error message is followed by the current input (usually a command), the current file, 
and record counts. A reminder is also printed that informs the operator he may override 
the error or terminate the process. The override is accomplished by pushing START 
with sense switch 3 reset. The update stream will be ignored until the next command 
record is detected. If sense switch 3 is set, the effect is the same as a DONE command. 
These error messages are shown in the examples. 

There is one I/O error message possible if the old master is being read from 
magnetic tape. A nonre cove rable read error will cause the message PARITY ERROR and 
the file and record counts to be printed. Following the printout, the computer halts. If 
the A register is cleared, another read will be attempted when START is pushed. If the 
A register is not cleared, the record will be accepted as read. Sense switch 2 will sup- 
press the error message when it is set, but not the halt (with all bits set in the A register). 
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Unexpected end-of-file marks or end-of-tape being sensed will cause a halt without 


an error message. 

Other messages are BREAK POINT HALT and END OF JOB. The BREAK POINT 
HALT is output when a HALT command was encountered, presumably for the operator to 
change the input stream. 

RESEQUENCE OPTION (Keyword) 

If the output is magnetic tape, SSUP can resequence card image columns 77 through 
80 by either l's or 10's depending upon the keyword in the A register at the start. If 
resequencing is selected, the ID field (columns 73 through 76) is taken from the first 
record to be written on the new master. The A register keywords for the various options 
are: 

'000000 - Resequence by 1 ' s 
'100000 - Resequence by 10's 
'040000 - Copy input verbatim 

SENSE SWITCH OPTIONS 

The functions of the sense switches are presented in Table 3-2. 


Table 3-2. SSUP Functions of Sense Switches 


Switch 

Condition 

F unction 

1 

Reset 

DAP- 16 format 


Set 

FORTRAN format 

2 

Reset 

Normal 


Set 

Suppress parity error 
mes sage 

3 

Reset 

Continue process on error 
re start 


Set 

Terminate process on error 
restart 

4 

Reset 

Normal 


Set 

Suppress transaction listing 


SOURCE FORMAT 

If paper tape or the Teletype is used, the format must be either the correct tab 
form for the specific language or in acceptable columns. FORTRAN tab settings are at 
columns 6, 7, and 73. DAP- 16 tabs are at columns 6, 12, and 30. Lines are opened 
with a line feed and closed with a carriage return. 
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Magnetic tape must have 80-character records. 

OPERATION 

The operator must load an SSUP system configured for the desired devices, since 
SSUP cannot be configured at run time. If magnetic tape is to be used, the old master 
must be mounted on logical unit 1 and the new master on logical unit 2. This is consistent 
with the assembler and compiler assignments. 

The A register must be set with the keyword, and the computer started at location 
'1000. Successive jobs must have the keyword restored and started at location '1000. 

If the output is being punched on paper tape, the operator must manually punch 
leading and trailing blanks and turn off the punch at the end of the job. 

SYSTEM GENERATION 

An SSUP system must be generated for each combination of I/O devices desired. 

The allowed combinations and required device drivers are: 


Old Master 

Magnetic Tape (logical unit 1) 

I$MA 

- 

Paper Tape Reader 

I$PA 

New Master 

Magnetic Tape (logical unit 2) 

0$MA 

- 

Paper Tape Punch 

0$PA 

Update 

Card Reader 

I$CA 

- 

Teletype 

I$AA 

- 

Paper Tape Reader 

I$PA 

Listing 

Teletype 

0$LL 

- 

Line Printer 

0$LA 

Messages 

Teletype 

0$LL 


The use of the Teletype as both the update master and the listing device is accept- 
able. The order of loading must not conflict with the above if the desired device stream 
attachments are to be made. 

If other combinations of I/O devices are desired it is possible to attach them by 
writing a driver which appears to SSUP-IOS as an allowable device. This is not supported 
by Honeywell. 

SSUP will operate in a 4K memory computer, but at least 8K is required to generate 
a system. 
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Load the ORGed SSUP and SSUP-IOS. Then select and load (consistently with the 
previously noted order) the desired device driver and support programs for the four 
streams. If the Teletype I/O library which includes OSLL was not loaded, do so at this 
point for the message output. Progress should be checked at this point by generating a 
memory map and observing that the correct calls are satisfied. Satisfy the remaining 
calls by loading SSUP-RDS, the associated dummy routine set. 

If magnetic tape is to be used, the type of I/O channel (DMA or DMC) and the 
channel number along with the iogical-dialed number relationship must be entered. Refer 
to the Programmers' Reference Manual of the appropriate option lor further instructions. 

EXAMPLE OF PAPER TAPE UPDATE 

The following file was punched with a Teletype to demonstrate the use of SSUP. It 
anticipates DAP format (i.e. , tab placement). All records start with a line feed and close 
with a carriage return. The use of an X-OF F and rubout is not required, since it will 
only be read by a paper tape reader. A nonprinting record following the printing text 
consists of a line feed, ETX, and carriage return. The ETX, w'hich is punched by 
simultaneous CTRL and C keys, is recognized as an end-of-file. 

0RG\REC\0NE 
ORG\REC\TWO 
ORG\REC\THREE 
ORG\REC\FOUR 
ORG\REC\FI VE 

The first step in most source updates is to obtain a list of the file with record 
numbers. In this case a copy of the file after corrections that were made during the 
original punching is also obtained. Note that the Teletype shows an echo of the commands. 

HIST 

SLIST 


SCOPYFl 

SC0PYF1 


00001 

0RG 

REC 

ONE 

00002 

0RG 

REC 

TWO 

00003 

0RG 

REC 

THREE 

00004 

0RG 

REC 

FOUR 

00005 

0RG 

REC 

FIVE 


$D0NE 

SDONE 

END OF JOB 
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The programmer decides that records 2 and 3 are to be replaced and a new record 
is to be inserted between records 4 and 5. He elects to list the transactions by leaving 
sense switch 4 reset. 

$ 0 0002,3 * FREE FORM - "0" AND "OMIT" ARE SYNONYMS 

$ 0 0002,3 * FREE FORM - "0" AND "OMIT" ARE SYNONYMS 

>00002 0RG REC TWO 

-00003 0RG REC THREE 

NEW RECORD AAA 
+00002 NEW RECORD AAA 
$D0LR . * CHANGE COMMAND INDICATOR 

$D01R . * CHANGE COMMAND INDICATOR 

.N 5 

.N 5 

$NEW RECORD BBB HAS A AS THE FIRST CHARACTER 
+00004 $NEW RECORD BBB HAS A "$" AS THE FIRST CHARACTER 
.COPY F 1 

.C0PYF1 

.DONE 

• DONE 

END OF JOB 

Since the new record starts with a control character, the command indicator in use 
was changed from a dollar sign to a period. 

As a final step the programmer listed the results. He chose not to copy the tape 
and because of this the listing shows each record as being deleted. In typing the com- 
mands, two errors were made to show the error messages. 
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SLIST 


SL1ST 

SOMIRF 1 

NON-VALID COMMAND 
SOMIRF 1 

FILE OOOO! .RECORD 00001 

SSW3 SET TO TERMINATE, RESET TO PROCESS NEXT COMMAND DEPRESS START, 
SOMITE 2, 1 

S0MITF2, 1 

LIMIT ERROR, 

S0MITF2, 1 

FILE OCOOI .RECORD 0000! 

SSW3 SET TO TERMINATE, RESET TO PROCESS NEXT COMMAND DEPRESS START. 
SOMITF 1 

S0M1TF1 

-00001 ORG REC ONE 

-00002 NEW RECORD AAA 
-00003 ORG REC FOUR 

-00004 SNEW RECORD BBB HAS A "$" AS THE FIRST CHARACTER 

-00005 ORG REC FIVE 

SNCPY 

SNCPY 

SDONE 

3D ONE 

END OF JOB 

EXAMPLE OF MAGNETIC TAPE UPDATE 

The first step to this example was to create three files by inserting records before 
the first record of a non-existent file. The cards used are shown as Figure 3-4. 

The programmer decided to update his source files by eliminating the first, chang- 
ing the second, and keeping the third intact. The original (or old master) remains 
intact. The new master contains entirely new data. 

Figures 3-5 and 3-6 are the transaction listing and a listing of the new master. 
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N 

1 



^■CRfcRlE FlLtr <z>KE 




F 

L E 

0R E 

R6C 

g>nie 



F 

Ll 


F 

L E 

0 Me 

Rtc 

Two 






$ 

$ 


WfCF 




% £RT> p F FILE 





N 

1 



#• CREftTe Fli-F T 1AJ0 




F 

L E 

T UJ ^ 

0R i 

Rec 

0MC 


F 

L Z 


F 

l e 

T fU 0 

0Ri<k 

Rec 

T0J(2f 





F 1 

1- E 

T ui 4 

0Ri(f 

Rec 

THREE 





F 

L E 

TKJ 0 

0R/6, 

REC. 

FpfuR. 





F 

L E 

T 

0R tty 

Rec 

FlV£ 





$ 

1 


W E 0 F 




XFRb £>p piLE THJ pf 




? 


NJ 

1 



* create File- three 




F I 

l e 

THREE 

REC 

0R>E 



F 1 

L 3 


F i 

L. E 

three 

Rec 

T uj o 






* 


Hi E r F 




* oF pjct THREE 




4 


UiE OF 




EMb OF VOLUME 




4 


Tore 









Figure 3-4. SSUP Example of Source for Magnetic Tape Update 
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$ 


LIST 


$ 0 M I TF *1 * SKIP A FILE 

-00001 FILE ONE REC ONE 

-00002 FILE ONE REC TWO 

-00003 END 

i 0 2 ♦ 3 

00001 FILE TWO ORIG REC ONE 

-00002 FILE TWO ORI& REC TWO 

-00003 FILE TWO ORIG REC THREE 

♦00002 NEW RECORD AAA 

$ DOLR • 


£ . N 5 

00003 FILE TWO ORIG REC FOUR 
♦ 0000 A SNEW RECORD BBB STARTS WITH A DOLLAR SIGN 

. CUPYF ,3 * REST OF TWO AND THREE 

00005 FILE TWO ORIG REC FIVE 

00006 END 

00001 FILE THREE REC ONE 

00002 FILE THREE REC TWO 

00003 END 

, WtOF # end of volume 


done 


Figure 3-5. SSUP Example of Full Listing Du 


FILiOOOl 
F,I LI 0001 . 
FILiOOOl 


FIL20001 

FIL20002 

FIL20002 

FIL20002 


FIL20003 

FIL2000A 


FIL20005 

FIL20006 

FIL30001 

FIL30002 

FIL30003 
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nit two ORIG RtC ONE 

F IL20001 


FILE TWU ORIG REC ONE 

fileduoi 


MEW RECORD AAA 

f lL«iQuO<! 


FILE TWO ORIG REC FOUR 

FIL^OUOO 


tNEw RECORD Rd8 STARTS WITH A DOLLAR SIGN 

F IL2 0UUA 


FILE TWU ORIG R6C FlVfc 

FIL^OUUS 


END 

F IL^OUUO 


FILE THREE RED ONE 

FIL40U01 


FILE THREE NEC ONE 

FIL300U1 


FILE THREc RED two 

F JLOOUOE 


End 

F I L 3 0 U 0 3 



Figure 3-6. SSUP Example of New Master 
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TYPICAL ASSEMBLY LISTING - CONDITIONAL TRACE tXAMPLE. 
1-19 
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GENERATION Of CALLING SFGLFNCE LSING SUfcRCUl I N'E b. 1-8 

CUDt 

GENERATION cf complftf in-line coding. 1-9 
IN-LINE CODING E XAMPl F-SCLWCE INPUT. 1-IC 
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1-18 

COMMAND 
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CONCORDANCE 
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CONDITION ASbFPHLY 
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MACRO OFF IN I T ION FOR CONDITIONAL TRACE EXAMPLE. 1-16 
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1-15 
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1-19 
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1-16 
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1-15 
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GENERAL DFbCRIRTlCN. l-J 2-1 
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ERRORS 

F R’RORS • 1-4 
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example-source 
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